Sets the system event mask of your application to the specified mask.

void SetEventMask (
    EventMask value
);

value

A value that specifies which events should be posted in the Operating System event queue. You specify the event mask using one or more of the values defined by “EventMask Constant”.

DISCUSSION

Your application should not call the SetEventMask function to disable any event types from being posted. Use SetEventMask only to enable key-up events if your application needs to respond to key-up events.

The SetEventMask function sets the system event mask of your application according to the parameter value. The Operating System Event Manager posts only low-level events (other than update or activate events) corresponding to bits in the system event mask of the current process when posting events in the Operating System event queue. The system event mask of an application is initially set to post mouse-up, mouse-down, key-down, auto-key, and disk-inserted events into the Operating System event queue.

AVAILABILITY

Supported in Carbon. Available in Mac OS 8.1 and later when Carbon 1.0.2 or later is present.

© 2000 Apple Computer, Inc. — (Last Updated 5/8/2000)